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SUBJECTS A generalized ready message program 

Attached to this HTB is the description of a generalized 
reaoy message command. It is a modification of the author 
maintained general„ready commands This new version is capable of 
printing both incremental and total values in the same ready 
message {although the total values are per~process totals only). 
The date and time can be printed in a number of different formats 
and new 6180 Huitics quantities such as memory units* level 
numbers* etc. can also' be printed. 

The new version of general_ready described in the attached 
MPH like description is operational, a version is available in 
>udc>R0HS>pubj ic>general_ready. 

One addition that has already been suggested is the 
replacement of the print messages facility with the more general 
capability of specifying a command line to be executed whenever 
the ready message procedure is invoked. 

Additional comments or suggestions should be directed to Jay 
Goloman HIT room 39-^11 or to Goldman. ROMS on the HIT Huitics. 



Huitics Project internal working documentation. Not to be 
reproduced or distributed outsioe the Huitics Project. 
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U3M£' general_ready, gr 

genera l_ready is a command which allows the user to set uo 
iortJ V m€ TK age containi "9 specific values in a user specified 
format. The program is designee to allow an aliost arbitrary 
format at no additional cost (relative to the B « 
proceoure) «*Hor. **->,* +w„ * . . . ,c *yi»«eiB s reacy 



other than the cost associated with the general reaoy 
:h sets up the reaoy message. Once a ready messac* 

sir. « b Sr.rsi%is s-fe^sr^-?- <° 



manner. 



general_ready builds up an ioa control strino from the 
oroer of the Keywords passed to it. The" keywords f h 
values to output in the ready message. Virtual cp£ usage, re a 
cpu usage, and aoJ I ar cost can be printed. Both increments 

ge'neral^d 9 :, *IZ™1 t't"" *** ,Mt ready -ssage'pr'te" b 
nro esl rl h f J ! 3 ' ? S39€ (uSag * accrued during this 
process) can be printea in the same ready message with thP 

r?atl S T>V ™*™**"* "»* ^mber of cecimal places o the 
right of the decimal point) specified by the user. 

- forma HpU^ ~ COnt^0, ° PtI ° nS - -"•«* °^ — 

not P specify Pt {hr af f «'* r * *°™at of the ready message but oo 

««-« L I«™5 !"* S (thS Va,U6S Wlnt«d> of the ready 
message. The format options specify both the contents and thl 

hV? rma° o ^reLr* 396 * ^ C ° ntr01 ° Pt *°-"° -Hf f ec? 
the format of the ready message, but instead control how the 

CseT T m hH^fr d °Ii er faclllti « s Provided by genera ready Ire 
J!?! I?* Pref + ix »P**o"s «ust occur before any format"" options^ 

Une! C ° ° Pti ° nS m3V 3PDear » n y»»»ere on the coLand 

The format ano content of the ready message is controlled bv 
forwt options. These options include: keyJcs h i 

values to be included in the ready message; opUonaV arguments 

c Copyright, 197^ Massachusetts Institute of Technology 
All Rights Reserved 



MTB - U3 

MULTICS PROGRAMERS' MANUAL 



J genera!_ready J 
Page 3 



following these keywords which control the number of digits after 
the decimal point in numeric values; and literal character 
strings which are inserted in the ready message. The format 
options are combined in the order of their appearance in the 
genera)_ready command to form an ioa_ control string which 
controls the format of the ready message. 

Six types of values may be used in a ready message: 
processor usage values (virtual and real cpu seconds); memory 
usage values (memory units); paging operations (both bulk store 
reaos and demand page faults); usage cost values (dollar 
charges); command processor level numbers', and date/time values 
(date, time of day, day of the week, etc). Both total usage 
values (total usage accrued during this process) and incremental 
usage values (usage accrued since the last ready message printed 
by general ready) can be output in the same ready message. The 
values are selected for use in the ready message by the format 
keyworcs which are given in the command. The format keywords are 
listed below by type. 



D 



processor usage values are selected from the following 
keywords. These keywords can be followed by an optional 
argument, a single numeric digit from l to 9, to indicate the 
number of digits which should appear to the right of the 
cecimal point in the number which is output. The default is 3 
cigits. The output format of the value can be described by 
ioa control string " ~.n.f" where d is 3 by default. 



the 



-ri 

-rcpui incremental real cpu value 

-rt 

-ncput total real cpu value 

-vi 

-vcpui incremental virtual cpu value 

-vt 

-vcput total virtual cpu value 

2) memory usage values are selected by the following keywords. 
These keywords are used in the same manner as the keyworas for 
processor usage values above. 

- me tr.or y i 
-mui 
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~merai Incremental memory units 

*»memoryt 

-memt 

-mut total memory units 

35 Mill HV V ^ ,U9S are S€,€Cteti ^ the following keywords. 
These keywords are used in the same manner as the keywords for 
processor usage values with the following differences Th* 
cefault number of digits following the Secima 'ootnt Is 2. 
The output format of the value can be described oy the ioa 
control string - $- oD r« wner€ ^ ls 2 by de fault! " 

-do! larsi 

-$L incremental cost charges 

-dollarst 

~$t total cost charges 

hi paging values are selected from the follwing keywords. These 

nT°f irsrnumbe^ X "tt i09 ~ C ° ntro1 Sfr '" 9 " ^^ "*•" 
Tne Tirst number is the number of bulk store oaaes read 

(formerly the number of pre-pages) and the second Is the 
number of demand page faults. 1S The 

-pagesi 

~pgi incremental paging values 

-pagest 

-pgt total paging values 

5) Keyword ""Sr wit" '„ ™f ^ *™ S * ,ecte * *>* the following 
keyword. This keyword indicates that the command processor 

messaoe Vo**^** ? UBberS Sh ° U ' d be includ.d ?n tE "Hy 
number of dioit? ?K a ', ar f ument ™y ^ used to control the 
number of digits. The level numbers are output by the ioa 

IT-lLeV ^VT- b, it the printed *«•■■? «- *. S2cr Sh 

by level d, d where the first number is the number of 
command processor invocations and the second is the stack 
frame depth of the ready message procedure's stack frame. If 
Tun ITrTnT. PPOCeSSOr ,eV€l 1S *• th « Panted for^r is the 

-level 

-iv command processor ieve! numbers 
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6) cafe values are selected by the following keywords. These 
values can be described by the ioa control string " ""a" except 
for the -win keyword which uses the ioa control string ""a" 
(without a leading space)* No optional argument may be used 
to control the number of digits. 

-dt date and time imra/dd/yy hhmm.m zzz www) 

-date 8 character date (mm/dd/yy) 

-hour 2 digit hour (hh) 

-minute 

-min 2 digit minute <mm) 

-time 

-tm 6 digit time of day {hhmm.m) 

-dow 3 character cay of week (www) 

-zone 3 character time zone (zzz) 

Note that all values except for the number of minutes 
I-minute) are preceded by a space and none of the values are 
suffixec by a space. Any non-keyword argument {other than a 
single numeric digit following a floating point or dollar 
keyword) is assumed to be a literal string which is inserted in 
ioa_ control string being built by genera l„ready. Refer to the 
examples below. 

£j2jDino.i aBiioms 

The following control options affect the operation of 
genera l_ready* but do not change the format of ready messages. 

-set 




each command line is complete. In addition* the system 
commands, ready. ready_on. and ready_off. will affect 
the operation of genera l_ready. 

-reset causes general_ready to make the system ready proc the 
-rs current ready message procedure* and to reset any timer 
alarms which were established to catch shift changes. 

c Copyright* 1974* Massachusetts Institute of Technology 
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-pr int__messages 

-pritsg when used with the -set control option, causes 
general_ready to call the print_messages (pra) program 
before printing the ready message. This allows the 
user to defer Messages queued by the 
ipc_message_faciiity until each command line has 
completed execution* Any queued messages are typed 
Just before the ready line, even if the ready_off 
command has been called to turn off ready messages* 

The -set and -reset control options are mutually exclusive. 
A general_ready command which includes -set does not print a 
reacy message. Instead, if saves the ioa_ control string built 
from the format options in the commands and uses this loa__ string 
to control the format of ready messages printed when command 
lines complete execution or when a ready command is issued. 

A general_ready command which includes -reset prints a 

single ready message* only if format options appear in the 

command with the -reset option. Otherwise, no ready message is 
printed. 

If neither -set nor -reset is given, then general_ready 
prints one ready message according to the format options given in 
the command. 

££jsiJLa fifftiona 

There are two prefix options. These options must occur prior 
to any of the format options described above. The two prefix 
options allow the user to override the default formats for the 
contents of the ready message, they are J 

-string allows the user to specify the character string at 
"S the beginning of the ready message. The argument 

following this option Is used instead of **r " at 
the beginning of the ready message. Since it is 
put into the ioa_ control string, •*/",■ *~R" and 
"~B" may be used to cause new lines, red ribbon 
shifts and black ribbon shifts, respectively. 



-control allows the user to specify the entire ioa_ control 

-ctl string used to format the ready message. The 

string will be passed to ioa_$nnl without change 

so it must contain specifications for each of the 

various values to be included in the ready 

c Copyright, i97<», Massachusetts Institute of Technology 
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message. The ioa_ control string formats for the 
various values which can be inserted into the 
ready message are given above for each type of 
value* This argument overrides any format control 
options which would normal I y affect the format of 
the ready message. However* format keywords must 
still be specified to indicate which values are to 
be output and the order in which these values 
correspond with the ioa_ control characters in the 
control string- 

EjJJJJLLfiS 

The following examples illustrate some of general_ready's 
facilities? 

gr -string READY -date ~xTIME -time ~xVCPU -vi -vcput -set 

The above command line establishes general^ ready as the current 
reaoy procedure since the -set keyword appeared. Each ready 
message would have the format* 

READY Ql/15/71* TIME 1234.3 VCPU 3.456 23.3*»9 

If the -sei keyword had not appeared* a single ready message 
having the above format would be printed. 

The ioa_ control string which general_ready uses to generate the 
above ready message would bei 

"READY ~a~xTIME ~a~xVCPU ~.3f ~.3f~2/" 

The command lines 

gr -s READY -date -hour 8 -min ~xVCPUI -vcpui -"xVCPUT 
-vcput 2 

would result in a single ready message of the formt 
READY 01/15/74 09S46 VCPUI 2.345 VCPUT 34.21 

using the ioa_ control strings 

"REAOY "a ~aS~a~xVCPUI ~.3f~xVCPUT ~,2f-2/" 

The above ready message could have been specified by the command 
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gr -ctl "READY ~a ~at**a VCPUI ". 3f VCPUT 
-hour -min -vcpui -vcput 



,2f-*2/ 8 



-date 



Jiais 

The total values printed by general_ready 
totals only. Since the system does not provide 
for processes other than the current process, 
not obtain information about usage in prior 
genera l__ready is invoked for the first time 
dollar cost of all usage <in that process) up to 
time is computed at the rates then in effect. 



are per-process 
usage information 
general_ready can 
processes* fchen 
in a process, the 
that point in 
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